home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / icomblt5.zip / README.1ST < prev    next >
Text File  |  1991-12-09  |  8KB  |  184 lines

  1. BULLETIN CAPTURE PROGRAM Ver 1.0CRICß  for CRS using ICOM
  2. Copyright (C) 1991 By John Leaver-Power
  3.  
  4.  
  5. SOFTWARE REQUIREMENTS
  6. *********************
  7. This packet contains a set of files for use with Intellicomm (ICOM
  8. 0.93) and PCB (14.5) used by CRS.  In addition, the program assumes your
  9. unarchive utility is PKUNZIP, although you can easily change this if
  10. needed. Lastly the program assumes your initial conference joined at
  11. logon is 2.  Strictly speaking this is not a requirement, but you should
  12. be aware that the script file will end by returning you to conference 2.
  13.  
  14.  
  15. PURPOSE
  16. *******
  17. The purpose is to incorporate your favorite bulletins into a downloaded
  18. mail packet whenever the "New Bulletins since last time on" message
  19. appears. Currently CRS does not allow downloading of bulletins either as
  20. files or within mail packets.  As an alternative to reading them online,
  21. this program will capture the bulletins using ICOM and rezip them into
  22. the current mail packet CRS.QWK.  They can then be read by your offline
  23. mail reader.  Any mail reader will work provided it supports bulletins
  24. in standard format.
  25.  
  26.  
  27. LIMITATIONS
  28. ***********
  29. There is no limit to the number of bulletins to monitor per conference,
  30. or to the number of conferences to check.
  31.  
  32. Since the bulletins are captured from the screen, the "download" time
  33. is much slower than with zipped files.  Essentially we are
  34. "downloading" in uncompressed format.  Typical scroll time is 1 minute
  35. for Bulletin 5 (Hot Files) using a 2400 bps modem.  Still much faster
  36. than reading online, but you should carefully select the bulletins to be
  37. monitored so that you don't run short of online time.
  38.  
  39. Due to my limited programming ability, the INSTALL program must be run
  40. from an empty directory or from a floppy disk.  Changing the bulletin
  41. list involves re-running the INSTALL program.
  42.  
  43. The captured bulletins will NOT be incorporated into CRS.QWK unless a
  44. mail packet is actually downloaded.  The bulletin files will remain in
  45. the capture directory, unknown to your mail reader, until CRS.QWK
  46. appears in the message directory, hopefully during your next BBS
  47. session.  If the New Bulletins are updated again by CRS and captured
  48. during your next session, they will over-write the old bulletins.
  49. To avoid this situation, use a text reader to examine the bulletins
  50. prior to your next mail session.
  51.  
  52. There is a problem with ICOM version 0.93 that may cause misaligned
  53. text and "freezing" of the program when used with a hi-speed modem, ie
  54. 14K bps or greater.  Wayne has promised a fix in the next version.
  55.  
  56.  
  57.  
  58. HOW IT WORKS
  59. ************
  60. Don't be scared off by the number of files in this packet.  Only 3 small
  61. files control the operation.
  62.  
  63. CAPBUL.SCR: Run from within an ICOM job, this script file starts the
  64.             operation, runs a batch file to see if your bulletins have
  65.             been updated, and if so, captures them to the appropriate
  66.             files.  The captured bulletins are in the format BLT-x.y
  67.             where "x" is the conference number, and "y" is the bulletin
  68.             number.
  69.  
  70. IFBUL.BAT: This file is called by CAPBUL.SCR above and tests to see if
  71.            your bulletins have been updated since your last time on.
  72.            If so, it creates a temporary flag file. When CAPBUL.SCR
  73.            detects this flag file it will start the capture.  The flag
  74.            file is R50HAU1V.TXT, a randomly generated name which
  75.            ensures no conflict with any existing files in your ICOM
  76.            directory.
  77.  
  78. POSTMAIL.BAT: When added to ICOM's POSTMAIL.BAT, these instructions
  79.               embed the captured bulletin files into your downloaded
  80.               CRS.QWK message packet.
  81.  
  82. All three files are created by INSTALL.EXE
  83.  
  84.  
  85. FILES           Bytes
  86. *****           *****
  87. README.1ST      7542    (You're reading it)
  88. INSTALL.EXE    45318    (Creates customized script & batch files)
  89. $COMPLET.CTL     224    (Used by INSTALL.EXE)
  90. $QUOTE.CTL        34    (Used by INSTALL.EXE)
  91. START.CTL        168    (Used by INSTALL.EXE)
  92. CHECKBLT.BAT      95    (Used by INSTALL.EXE)
  93. GETBLTOP.SCR      77    (Used by INSTALL.EXE)
  94. IFBUL001.BAT     464    (Used by INSTALL.EXE)
  95. REPLACE.COM    14004    (Used by INSTALL.EXE)
  96. FGREP.COM       4878    (Used by IFBUL.BAT and copied to your capture dir.)
  97. MAKELINE.EXE   16592    (Used by IFBUL.BAT and copied to your capture dir.)
  98. REPLACE.DOC    12323    (Legal requirement)
  99. FGREP.DOC      22885    (Legal requirement)
  100.  
  101.  
  102. LEGAL STUFF
  103. ***********
  104. I originally intended to release this program as freeware but decided
  105. otherwise after almost four weeks of work.  Accordingly, it is now a
  106. SHAREWARE program.  This SHAREWARE license does not include the REPLACE,
  107. FGREP and MAKELINE files which are not my creation.  Keeping a low budget
  108. in mind, I am requesting the enormous amount of $5.00. (Cdn yet!)
  109. Why should you register?  Aside from currently being a significant
  110. source of income to me, I'm putting together a collection of small ICOM
  111. add-ons that I've made to date.  ALL future updates to this "tool box",
  112. as well as any new programs I make for ICOM, will be available to you
  113. AT NO FURTHER COST via CRS.  Hopefully with enough funds, I can
  114. buy a few basic programming tools to develop better additions to the
  115. "tool box".  If you find this program useful, please send your cheque
  116. to:
  117.         John Leaver-Power
  118.         25 Mabelle Avenue
  119.         Suite 1208
  120.         Etobicoke, Ontario
  121.         M9A 4Y1
  122.  
  123.  
  124.  
  125. INSTALLATION
  126. ************
  127. Copy all of the above files to an EMPTY directory on your hard disk, or
  128. to a floppy diskette.  The hard disk option will run significantly
  129. faster.
  130. From DOS, change to the directory/floppy, and type INSTALL
  131.  
  132. You will need the following information to run INSTALL:
  133.         The drive letter and directory name which contains ICOM.EXE,
  134.         The directory names which contain your SCRIPT and CAPTURE files,
  135.         The name of your capture file, usually ICOM.CAP.  This filename
  136.         must be common to all the Jobs which use this bulletin capture
  137.         program.
  138.         The directory name which contains your mail packets from CRS.
  139.  
  140. After the installation, I recommend keeping all the program files in an
  141. empty directory so you can easily reconfigure the "Bulletin List" at any
  142. time.  I use C:\ICOM\BLTCFG\ as the storage directory.
  143.  
  144. Then modify the ICOM job(s) to include the @CAPBUL script.
  145. This is done from within ICOM's Job Directory window.  For example, a
  146. job called CRSMAIL which sends replies and gets new mail would look like
  147. this:
  148.  
  149.         Call Canada Remote System
  150.           CC:@CAPBUL
  151.           Drop off message replies
  152.           Get all new mail
  153.         Exit to DOS
  154.  
  155.  
  156.  
  157. CHANGING THE BULLETIN LIST
  158. **************************
  159. Run INSTALL.EXE again.
  160.  
  161. To remove ALL bulletins from ALL conferences, press F10 when first
  162. provided with this option.
  163.  
  164. This version of INSTALL cannot recall your old configuration, so the
  165. safest way to make changes is to re-enter your complete list.  As I get
  166. better at programming, this may change.
  167.  
  168.  
  169.  
  170. NOTE TO PMDBM USERS
  171. *******************
  172. If you use one of my other "tools", FLIST.BAT (NFICPM5.ZIP), to View
  173. New Files using ICOM's Tagger program, there is a simple addition to
  174. FLIST that will invoke INSTALL when needed.  Drop me a line, and I'll
  175. send you the details.
  176.  
  177.  
  178. USAGE
  179. *****
  180. This is the easy part. Just run the job as you normally would, and stand
  181. back!
  182.  
  183. That's it.  Enjoy.
  184.